home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / tex / ftp.nwc < prev    next >
INI File  |  1994-10-19  |  9KB  |  231 lines
  1. [unixtex.ftp: 28 September 1994]
  2.  
  3. The master version of this file is on ftp.cs.umb.edu [158.121.104.33]
  4. in pub/tex/unixtex.ftp. Mail kb@cs.umb.edu with comments or questions.
  5.  
  6. =========================================================================
  7.              Consider joining the TeX Users Group (TUG):
  8.   support the maintenance and development of the programs you retrieve.
  9.               Send membership request to: tug@tug.org.
  10. =========================================================================
  11.  
  12.             FTP INSTRUCTIONS
  13.  
  14. ... for Unix sites wanting to install (plain) TeX, LaTeX, BibTeX, plain
  15. Metafont, an X window system previewer, a PostScript device driver, and
  16. an HP LaserJet device driver.
  17.  
  18. Use the host nearest you:
  19.  
  20.     Host            Internet address    TeX root dir
  21.     ----            ----------------    ------------
  22.     ftp.shsu.edu        192.92.115.10        tex-archive
  23.     ftp.tex.ac.uk        134.151.44.19        tex-archive
  24.     ftp.dante.de        128.69.1.12        tex-archive
  25.     
  26.     For additional hosts, see /README.mirrors on these sites or
  27.     finger ctan_us@ftp.shsu.edu.
  28.  
  29. All the CTAN hosts have these files:
  30.     /README.archive-features
  31.     /README.site-commands 
  32. Our instructions assume you have read these.
  33.  
  34. If you do not have GNU's gunzip utility, first retrieve and install the
  35. gzip package.  Set "binary" mode by typing "bi" at your ftp prompt; retrieve
  36.  
  37.     /tex-archive/tools/info-zip/gzip-<version>.tar
  38.  
  39. gzip does a better job of compression than standard Unix compress, and
  40. it is (as far as is known) patent-free.  It is illegal to use Unix
  41. compress (in the USA), because it infringes a software patent.  Write to
  42. the League for Programming Freedom <lpf@uunet.uu.net> for information
  43. about fighting the new software monopolies in the US.
  44.  
  45.  
  46. Retrieving a basic set of input files and fonts:
  47. -----------------------------------------------
  48.  
  49. ftp> cd tex-archive/systems/web2c
  50. ftp> bi
  51. ftp> get lib.tar.gz
  52.  
  53.      This file contains a minimal collection of fonts (TFM files only),
  54.      (La)TeX macros, MF macros, and BibTeX files -- enough to get
  55.      started. The AMS fonts and macros are included.
  56.      
  57.      lib.tar.gz unpacks into a directory named `texmf', which you will
  58.      want in your equivalent of /usr/local/lib -- whatever you will
  59.      define as your $(datadir) in the Makefiles.
  60.  
  61.      The organization of the archive was debated at great length. We hope
  62.      it will be useful. If you don't like our organization, feel free to
  63.      move the files around as you see fit, not forgetting to redefine the
  64.      search paths and installation directories. The Makefiles,
  65.      kpathsea/HIER, kpathsea/paths.h.in, and web2c/README (``Directory
  66.      hierarchies'') have more information.
  67.  
  68.      You must decide on your directory structure *before* doing the
  69.      compilations, since you must specify default search paths, and
  70.      since the web2c Makefile tries to create the basic .fmt and .base
  71.      files, which require the .{tex,mf,tfm} input files to be in place.
  72.  
  73.  
  74. Retrieving web2c (that is, TeX, Metafont, and friends):
  75. ------------------------------------------------------
  76.  
  77. Still in tex-archive/systems/web2c:
  78.  
  79. ftp> get web.tar.gz    [Knuth's WEB sources for TeX, MF, & family:
  80.              unpacks into ./web2c-<version>]
  81. ftp> get web2c.tar.gz    [WEB-to-C source: also unpacks into ./web2c-<version>]
  82.  
  83.      You *must* retrieve and unpack *both* web.tar.gz and web2c.tar.gz.
  84.      
  85.  
  86. Retrieving device drivers:
  87. -------------------------
  88.  
  89.        For an X window system previewer (xdvik):
  90. ftp> cd /tex-archive/dviware/xdvik
  91. ftp> get xdvik.tar.gz    [unpacks into ./xdvik-<version>]
  92.  
  93.        For a DVI-to-PostScript translator (dvipsk):
  94. ftp> cd /tex-archive/dviware/dvipsk
  95. ftp> get dvipsk.tar.gz    [unpacks into ./dvipsk-<version>]
  96.  
  97.        For a DVI-to-PCL translator (dviljk):
  98. ftp> cd /tex-archive/dviware/dviljk
  99. ftp> get dviljk.tar.gz    [unpacks into ./dviljk-<version>]
  100.  
  101.       [optional] For prebuilt bitmaps:
  102. ftp> cd /tex-archive/fonts/cm/pk
  103. ftp> get pk300.zip
  104.      These bitmapped fonts were generated by Metafont using the CanonCX
  105.      mode_def for write-black 300dpi devices.
  106.  
  107.      If using the default search paths, place this set of 
  108.      Computer Modern fonts in $(fontdir)/public/cm/pk/cx.
  109.  
  110.      This is optional because the drivers can run a script called
  111.      MakeTeXPK (sample supplied) to generate fonts as needed.
  112.  
  113.      The zip/unzip package is in /tex-archive/tools/info-zip.
  114.  
  115. ftp> quit        [end ftp session]
  116.  
  117.  
  118. Compilation and installation:
  119. ----------------------------
  120.  
  121. Each of these packages -- web2c, xdvik, dvipsk, dviljk -- contains its
  122. own installation instructions.  It is possible to build all the programs
  123. in a single make, but it is simpler to make them separately.
  124.  
  125. Compile web2c first (i.e.,, the material in both web.tar.gz and
  126. web2c.tar.gz, unpacked).  Begin by reading
  127.  
  128.     ./web2c-<version>/README
  129.     ./web2c-<version>/web2c/README
  130.     ./web2c-<version>/web2c/INSTALL
  131.     ./web2c-<version>/kpathsea/README
  132.     ./web2c-<version>/kpathsea/INSTALL
  133.  
  134. The INSTALL files are your guides to installation.
  135.  
  136. Remember to set up your texmf directory hierarchy before embarking on 
  137. your compilation (see "For a basic set of input files and fonts" above).
  138.  
  139. All installation processes require careful attention to detail, and
  140. knowledge of your system.  Festa lente -- make haste slowly -- and you
  141. improve your chances of success.
  142.  
  143.  
  144. BUG: wchar_t is impossible to get right. If you get error messages
  145. involving foil_x_wchar_t, try
  146.   make CFLAGS="-g -DNO_FOIL_X_WCHAR_T"  (for web2c); or
  147.   make CFLAGS="--g -DFOIL_X_WCHAR_T" (for everything else).
  148.  
  149. BUG: I messed up and declared alloca in web2c/web2c/web2c.h. Just delete
  150. the declaration. ftp.cs.umb.edu:pub/tex/web2c.alloca.help does this.
  151.  
  152. BUG: Contrary to what the web2c installation instructions imply, you must use
  153.    configure --prefix=/your/tex/root
  154. instead of editing the prefix in the Makefile(s). (Editing does work in
  155. some cases, but not all.)
  156.  
  157. BUG: make clean removes *.pool in web2c/tex and web2c/mf. Use make
  158. distclean or make mostlyclean instead. Or edit tex/Makefile and
  159. mf/Makefile to remove *.pool at distclean instead of clean.
  160. ftp.cs.umb.edu:pub/tex/web2c.pool.help does this.
  161.  
  162. BUG: The kpathsea that comes with web2c is an older version (1.6) of
  163. what is in the other distributions (2.1). The file web2c.kpathsea.help
  164. will make web2c work with kpathsea 1.8, which is somewhat of an
  165. improvement.  People are working on a patch for the latest kpathsea.
  166.  
  167.  
  168. Further help:
  169. ------------
  170.  
  171. The tex-archive/help and tex-archive/info directories on the CTAN sites
  172. have much additional documentation on all aspects of TeX.
  173.  
  174.  
  175. Distribution on tape and CD/ROM:
  176. -------------------------------
  177.  
  178. For TeX on a single tape (4mm DAT or QIC-24), ordering information is
  179. available from unixtex@u.washington.edu.  A distribution fee in the area
  180. of US$210.00 covers administrative costs.  Tapes will be available at
  181. least through summer of 1994.
  182.  
  183. The Free Software Foundation distributes the minimal TeX system
  184. described here on CD/ROM. Write gnu@prep.ai.mit.edu for ordering info.
  185.  
  186. Other organizations also have TeX on a CD/ROM, but I do not know the
  187. details to include them here. Tell me if you have more info.
  188.  
  189.  
  190. Retrieving TeX executables:
  191. --------------------------
  192.  
  193. (Original from George D. Greenwade <bed_gdg@SHSU.edu>, but slightly edited.)
  194.  
  195. The files in /tex-archive/systems/unix/unixkit/ are minimal sets of
  196. precompiled executables (thanks to Sebastian Rahtz for making these sets
  197. available) for the various platforms using the latest web2c (version
  198. 6.1) package and techniques outlined in unixtex.ftp.  The one exception to
  199. this is the file share.tar.gz, which includes man pages and pool files
  200. for the distribution which may be used across all architectures.
  201.  
  202. Specifically excluded from this distribution in unixkit are the many
  203. additional macros and styles, fonts, and utilities which are available
  204. elsewhere in the CTAN archives -- the idea is to have the ability to get
  205. the latest files, but still have them in workable chunks for retrieval
  206. purposes. [Retrieve lib.tar.gz as discussed above for the minimal
  207. font/macro files.]
  208.  
  209. You *must* use the default location, /usr/local/lib/texmf, for your TeX
  210. macros, fonts, etc. if you use these binaries.  If you cannot use that
  211. directory, then retrieve the sources and recompile.
  212.  
  213. If you get these binaries, you do not need to get web.tar.gz and web2c.tar.gz.
  214.  
  215.  
  216. Acknowledgements:
  217. ----------------
  218.  
  219. The three main sites listed above are part of the Comprehensive TeX Archive 
  220. Network (CTAN) --  the result of cooperative work among members of TUG, 
  221. DANTE [German-speaking TeX Users Group], and UKTUG [U.K. TeX Users Group], 
  222. under the leadership of George Greenwade, Chair for TUG's Technical 
  223. Working Group on TeX Archive Guidelines.
  224.  
  225. Special thanks to George Greenwade for establishing the CTAN site at 
  226. Sam Houston State University (US); to Rainer Schoepf, Barbara Burr, 
  227. and members of DANTE for the CTAN site in Heidelberg (Germany); and to 
  228. Sebastian Rahtz for the CTAN site in Cambridge (UK).
  229.  
  230. This file was conceived and created by Elizabeth Tachikawa.
  231.